keyUp

Type

message

Summary

Sent when the user releases a pressed key.

Syntax

keyUp <pKeyName>

Description

Handle the keyUp message if you want to do something special when the user releases any key (or a particular key you check for in the handler).

The message is sent to the active (focused) control, or to the current card if no control is focused.

If the key pressed is the Return, Tab, Backspace, Delete, or Enter key, an arrow key, or a function key, no keyUp message is sent.

Cross-platform note

On Mac OS systems, the keyUp message is sent after any keyDown handlers finish executing, whether or not the key has been released. On Unix and Windows systems, the keyUp message is sent when the key is released, after the typed character has been added to the current field. To test whether a key is actually being pressed, use the keysDown function.

Parameters

Name	Type	Description
pKeyName		The actual character of the pressed key.

Examples

on keyUp -- play a keyclick sound
  -- in this example, the parameter is not needed or used
  play audioClip "click"
end keyUp

Related

function: keysDown

glossary: handler, Unix, message, Windows, Mac OS, execute

keyword: field

message: keyDown

command: focus

control structure: function

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile